Documentation on uvspect
Task: uvspect
Purpose: Analyse uvdata spectra and plot amplitude phase spectra
Categories: uv analysis, plotting
UVSPECT is a Miriad task to analyse and plot visibility spectra.
Plot Amplitude and Phase versus channel, frequency or velocity.
The default is to average the selected uvdata for all baselines
and polarizations. UVSPECT does not apply the gains, or bandpass
corrections when plotting the data.
Key: vis
The input visibility file. No default.
Key: device
PGPLOT device (e.g. /retro, plot.plt/im for hardcopy on a Vax,
or /sunview, plot/ps for harcopy on a Sun). No default.
See documentation on the device keyword for more information.
Key: interval
Averaging interval in minutes. Default is no averaging.
Key: select
Standard uvdata selection. Default is all visibilities. See
documentation on the select keyword for more information.
Key: line
Line type of the data in the format
type,nchan,start,width,step
Here "type" can be `channel', `wide' or `velocity'.
Default is all channels.
Key: fmode
Flagging type to plot. Set fmode=a to plot flagged and unflagged
data. fmode=u to plot unflagged data, fmode=f to plot flagged data.
Default is to plot all data.
Key: fft
fft is a character string describing the FFT processing options.
Default fft=' ' does no FFT processing. Other options take the
complex FFT for each record and each spectral window before
averaging the data.
+ The sign of the exponent in the FFT.
- The sign of the exponent in the FFT.
s Add a phase gradient of pi per channel before the FFT
This produces a half channel shift after the FFT.
q Quad swap the input to move the center to the 1st point.
h Hanning smooth the output.
Use fft=-qsh to make frequency spectra from HATCREEK correlator
lag data with the lsb and usb of LO1 adjacent for each corf.
The input uvdata must be the default all spectral channels with
the number of channels in each window being a power of 2.
Other options to take the FFT of any input line type are possible
but not yet implemented.
Key: hann
Hanning smoothing length (an odd integer 15). Is applied after
averaging over time. Default is no smoothing (hann=1).
Key: xrange
Plot range in the x-direction (in channels or km/s according to
the linetype selected). Default is to self-scale.
Key: amprange
Plot range for amplitude in the y-direction (in intrinsic units).
Default is to self-scale.
Key: phirange
Plot range for phase in the y-direction (in degrees).
Default is (-180,180) degrees.
Key: mode
Mode can be 'inter' or 'batch'. Default is inter. In either mode,
the user is prompted for options after each plot on a non-hardcopy
device. The options are applied to the current spectrum, which can
then be replotted. mode=inter displays the cursor. Type the first
character and cr to select option. The cursor handling is device
dependent, and the character and cr may need to given several times.
Options:
Device - enter new plot device.
Limits - change plot limits.
Channel - change x-axis to channel number in the line keyword.
Velocity - change x-axis to velocity.
Frequency - change x-axis to frequency.
Replot - replot current spectrum.
Position - display cursor position. (if device supports a cursor)
Write - write out current spectrum to an ascii file.
Quit - stop processing and exit from task.
End - end of options, get next average.
cr - go to next time average.
The original inputs are restored for the next time average.
Generated by rsault@atnf.csiro.au on 11 Jul 1996